To import remote VSAM files with matching local VSAM files from COBOL FD (File Definition) files (CICS) - MVS-z/OS

In the current example, the local and remote CONNX sample VSAM Customer KSDS CICS file definitions (CNXCSTK and CNXCSTX) point to different physical VSAM datasets with identical file attributes, record counts, and formats. Note that, in the above procedure, no indexes were imported for the CUSTOMERS_VSAM_REMOTE KSDS file (CNXCSTX). CONNX supports SQL requests against remote files without matching local files, but whenever a matching local file exists, importing the indexes from the local file (CNXCSTK in the above example) improves performance.

  1. Click the Import button in the CONNX Data Dictionary Manager window.

  2. The Import CDD dialog box appears.

  3. Select VSAM COBOL FD files in the Import Type list box.

  4. Type a CICS user name and password in the User Name and Password text boxes.

  5. The TCPIP port number is set to 6500 by default, but can be configured via the CONNX NX01 CICS transaction. See "To convert the CONNX port number to the default" in the CONNX Installation Guide for configuration information.

  6. Select a Destination Database from the list box. See Add a Database Connection for more information.

  7. Type a COBOL FD partitioned data set and member name in the Enter a COBOL FD data set member text box.

  8. Specify the fully qualified PDS (partitioned data set) and member name for the COBOL FD, for example, CONNX.VVRR.COPYBOOK(CUSTOMRX). A COBOL FD specification does not contain the corresponding CICS File Control Table (FCT) name; therefore, it must be specified on the Table Properties tab in the CONNX Data Dictionary Manager window when the data is returned.

  1. All of the record layouts in the specified file are imported.

  2. No additional logon information is required.

  1. Select each file to import and follow these steps:

  1. Select the VSAM file definition in the upper pane (CUSTOMERS_VSAM_REMOTE in this example) and click the Table Properties tab in the CONNX Data Dictionary Manager window.

  2. Type the matching local CICS RDO or FCT name for the remote file in the CICS File Name text box. For example, the local CICS short file name for the CONNX VSAM KSDS sample customer file is CNXCSTK. In this example, both the local and the remote Customers VSAM files are defined as KSDS files with identical attributes, but only the local CICS short file name contains complete information such as record length, key offset, and key length. To import this information into the CONNX CDD, key in the matching local CICS short file name (CNXCSTK):

    rmt13.jpg
     

  3. Tab out of the CICS File Name text box to display the CONNX Database Logon dialog box. Click the OK button.

  4. Click the Table Indexes tab to display the key information for the imported CICS VSAM file.  

    rmt14.jpg
     

  5. Finally, select the Table Properties Tab, change the CICS short file name to the remote file name (CNXCSTX), and save the CDD file without tabbing out of the CICS File Name text box:

    rmt15.jpg
     

  1. The definition of the remote Customer VSAM KSDS file using the matching local file attributes is complete. SQL queries against CUSTOMERS_VSAM_REMOTE are mapped to remote file CNXCSTX.